home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / map_indices < prev    next >
Text File  |  2001-04-06  |  1KB  |  32 lines
  1. SYNOPSIS
  2.         mapping map_indices(mapping m, string func, string|object ob, ...)
  3.         mapping map_indices(mapping m, closure cl, ...)
  4.  
  5. DESCRIPTION
  6.         ob->func() is called resp. cl applied to every element in the mapping,
  7.         with the key of the element as first argument, and then the extra args
  8.         that were given to map_indices (these args must not be protected
  9.         references like &(i[0])).  The data item in the mapping is replaced by
  10.         the return value of the function. ob can also be a file_name of an
  11.         object.
  12.  
  13.         If <ob> is omitted, or neither a string nor an object, it
  14.         defaults to this_object().
  15.  
  16.         Note that if mapping m has more than one value per key, these
  17.         are ignored: the resulting mapping always has one value per key.
  18.  
  19.         Also note that the behaviour of this function is different from
  20.         map_array().
  21.  
  22. EXAMPLE
  23.         m = mkmapping(users());
  24.         m = map_indices(m, #'environment);
  25.  
  26. HISTORY
  27.         In LDMud 3.2.6 renamed from map_mapping() and complemented by map().
  28.  
  29. SEE ALSO
  30.         map(E), filter(E), filter_indices(E), walk_mapping(E), member(E),
  31.         m_contains(E)
  32.